home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3g / strccpy.z / strccpy
Encoding:
Text File  |  1998-10-20  |  6.7 KB  |  132 lines
  1.  
  2.  
  3.  
  4. ssssttttrrrrccccccccppppyyyy((((3333GGGG))))                                                        ssssttttrrrrccccccccppppyyyy((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _ssss_tttt_rrrr_cccc_cccc_pppp_yyyy: _ssss_tttt_rrrr_eeee_aaaa_dddd_dddd, _ssss_tttt_rrrr_cccc_aaaa_dddd_dddd, _ssss_tttt_rrrr_eeee_cccc_pppp_yyyy - copy strings, compressing or
  10.      expanding escape codes
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      _cccc_cccc [_f_l_a_g ...] _f_i_l_e ...  _----_llll_gggg_eeee_nnnn [_l_i_b_r_a_r_y ...]
  14.  
  15.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_llll_iiii_bbbb_gggg_eeee_nnnn_...._hhhh_>>>>
  16.  
  17.      _cccc_hhhh_aaaa_rrrr _****_ssss_tttt_rrrr_cccc_cccc_pppp_yyyy _((((_cccc_hhhh_aaaa_rrrr _****_o_u_t_p_u_t_,,,, _cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_i_n_p_u_t_))))_;;;;
  18.  
  19.      _cccc_hhhh_aaaa_rrrr _****_ssss_tttt_rrrr_cccc_aaaa_dddd_dddd _((((_cccc_hhhh_aaaa_rrrr _****_o_u_t_p_u_t_,,,, _cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_i_n_p_u_t_))))_;;;;
  20.  
  21.      _cccc_hhhh_aaaa_rrrr _****_ssss_tttt_rrrr_eeee_cccc_pppp_yyyy _((((_cccc_hhhh_aaaa_rrrr _****_o_u_t_p_u_t_,,,, _cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_i_n_p_u_t_,,,, _cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr
  22.          _****_e_x_c_e_p_t_i_o_n_s_))))_;;;;
  23.  
  24.      _cccc_hhhh_aaaa_rrrr _****_ssss_tttt_rrrr_eeee_aaaa_dddd_dddd _((((_cccc_hhhh_aaaa_rrrr _****_o_u_t_p_u_t_,,,, _cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_i_n_p_u_t_,,,, _cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr
  25.          _****_e_x_c_e_p_t_i_o_n_s_))))_;;;;
  26.  
  27. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  28.      _ssss_tttt_rrrr_cccc_cccc_pppp_yyyy copies the _i_n_p_u_t string, up to a null byte, to the _o_u_t_p_u_t string,
  29.      compressing the C-language escape sequences (for example, _\\\\_nnnn, _\\\\_0000_0000_1111) to
  30.      the equivalent character.  A null byte is appended to the output.  The
  31.      _o_u_t_p_u_t argument must point to a space big enough to accommodate the
  32.      result.  If it is as big as the space pointed to by _i_n_p_u_t it is
  33.      guaranteed to be big enough.  _ssss_tttt_rrrr_cccc_cccc_pppp_yyyy returns the _o_u_t_p_u_t argument.
  34.  
  35.      _ssss_tttt_rrrr_cccc_aaaa_dddd_dddd is identical to _ssss_tttt_rrrr_cccc_cccc_pppp_yyyy, except that it returns the pointer to
  36.      the null byte that terminates the output.
  37.  
  38.      _ssss_tttt_rrrr_eeee_cccc_pppp_yyyy copies the _i_n_p_u_t string, up to a null byte, to the _o_u_t_p_u_t string,
  39.      expanding non-graphic characters to their equivalent C-language escape
  40.      sequences (for example, _\\\\_nnnn, _\\\\_0000_0000_1111).  The _o_u_t_p_u_t argument must point to a
  41.      space big enough to accommodate the result; four times the space pointed
  42.      to by _i_n_p_u_t is guaranteed to be big enough (each character could become _\\\\
  43.      and 3 digits).  Characters in the _e_x_c_e_p_t_i_o_n_s string are not expanded.
  44.      The _e_x_c_e_p_t_i_o_n_s argument may be zero, meaning all non-graphic characters
  45.      are expanded.  _ssss_tttt_rrrr_eeee_cccc_pppp_yyyy returns the _o_u_t_p_u_t argument
  46.  
  47.      _ssss_tttt_rrrr_eeee_aaaa_dddd_dddd is identical to _ssss_tttt_rrrr_eeee_cccc_pppp_yyyy, except that it returns the pointer to
  48.      the null byte that terminates the output.
  49.  
  50. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  51.      _////_**** _eeee_xxxx_pppp_aaaa_nnnn_dddd _aaaa_llll_llll _bbbb_uuuu_tttt _nnnn_eeee_wwww_llll_iiii_nnnn_eeee _aaaa_nnnn_dddd _tttt_aaaa_bbbb _****_////
  52.      _ssss_tttt_rrrr_eeee_cccc_pppp_yyyy_(((( _oooo_uuuu_tttt_pppp_uuuu_tttt_,,,, _iiii_nnnn_pppp_uuuu_tttt_,,,, _""""_\\\\_nnnn_\\\\_tttt_"""" _))))_;;;;
  53.      _////_**** _cccc_oooo_nnnn_cccc_aaaa_tttt_eeee_nnnn_aaaa_tttt_eeee _aaaa_nnnn_dddd _cccc_oooo_mmmm_pppp_rrrr_eeee_ssss_ssss _ssss_eeee_vvvv_eeee_rrrr_aaaa_llll _ssss_tttt_rrrr_iiii_nnnn_gggg_ssss _****_////
  54.      _cccc_pppp _==== _ssss_tttt_rrrr_cccc_aaaa_dddd_dddd_(((( _oooo_uuuu_tttt_pppp_uuuu_tttt_,,,, _iiii_nnnn_pppp_uuuu_tttt_1111 _))))_;;;;
  55.      _cccc_pppp _==== _ssss_tttt_rrrr_cccc_aaaa_dddd_dddd_(((( _cccc_pppp_,,,, _iiii_nnnn_pppp_uuuu_tttt_2222 _))))_;;;;
  56.      _cccc_pppp _==== _ssss_tttt_rrrr_cccc_aaaa_dddd_dddd_(((( _cccc_pppp_,,,, _iiii_nnnn_pppp_uuuu_tttt_3333 _))))_;;;;
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. ssssttttrrrrccccccccppppyyyy((((3333GGGG))))                                                        ssssttttrrrrccccccccppppyyyy((((3333GGGG))))
  70.  
  71.  
  72.  
  73. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  74.      _ssss_tttt_rrrr_iiii_nnnn_gggg(3C), _ssss_tttt_rrrr(3G)
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.                                                                         PPPPaaaaggggeeee 2222
  129.  
  130.  
  131.  
  132.